﻿
namespace RoughHtml.w3c
{
    public interface ErrorHandler
    {
        
  /**
    * Receive notification of a warning.
    *
    * <p>CSS parsers will use this method to report conditions that
    * are not errors or fatal errors as defined by the XML 1.0
    * recommendation.  The default behaviour is to take no action.</p>
    *
    * <p>The CSS parser must continue to provide normal parsing events
    * after invoking this method: it should still be possible for the
    * application to process the document through to the end.</p>
    *
    * @param exception The warning information encapsulated in a
    *                  CSS parse exception.
    * @exception CSSException Any CSS exception, possibly
    *            wrapping another exception.
    * @see CSSParseException 
    */
   void warning(CSSParseException exception) ;

  /**
    * Receive notification of a recoverable error.
    *
    * <p>This corresponds to the definition of "error" in section 1.2
    * of the W3C XML 1.0 Recommendation.  For example, a validating
    * parser would use this callback to report the violation of a
    * validity constraint.  The default behaviour is to take no
    * action.</p>
    *
    * <p>The CSS parser must continue to provide normal parsing events
    * after invoking this method: it should still be possible for the
    * application to process the document through to the end.  If the
    * application cannot do so, then the parser should report a fatal
    * error even if the XML 1.0 recommendation does not require it to
    * do so.</p>
    *
    * @param exception The error information encapsulated in a
    *                  CSS parse exception.
    * @exception CSSException Any CSS exception, possibly
    *            wrapping another exception.
    * @see CSSParseException 
    */
   void error(CSSParseException exception) ;

  /**
    * Receive notification of a non-recoverable error.
    *
    * <p>This corresponds to the definition of "fatal error" in
    * section 1.2 of the W3C XML 1.0 Recommendation.  For example, a
    * parser would use this callback to report the violation of a
    * well-formedness constraint.</p>
    *
    * <p>The application must assume that the document is unusable
    * after the parser has invoked this method, and should continue
    * (if at all) only for the sake of collecting addition error
    * messages: in fact, CSS parsers are free to stop reporting any
    * other events once this method has been invoked.</p>
    *
    * @param exception The error information encapsulated in a
    *                  CSS parse exception.  
    * @exception CSSException Any CSS exception, possibly
    *            wrapping another exception.
    * @see CSSParseException
    */
   void fatalError(CSSParseException exception) ;
    }
}
